gtk/main: Stack ::active calls

We may have the situation of multiple touchpoints in the same
widget, or combinations with other devices. Stack those ::active
states are preserved on widgets on all but the last pointer/touch
going away.

gtk/main: Toggle active flag with touch events

This went missing at some point, add the missing toggling of active
state with GDK_TOUCH_BEGIN/END/CANCEL events.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3348

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2819

a11y: Use GROUP role for ShortcutsShortcut

And hide the image from the accessible tree.

a11y: Implement atspi.Text.ScrollSubstringTo for GtkTextView

We reuse the existing implementation in GTK3.

a11y: Document GtkRevealer's accessible state

Use the GROUP role, and make sure to note that the child is always
revealed. Unlike GtkExpander, GtkRevealer can only be programmatically
toggled, so we cannot turn it into a "button" object.

a11y: Add more accessible data to GtkTreeExpander

Document the role of the GtkTreeExpander, and the behaviour of the
expander button.

Additionally, improve the label of the expander button, by adding a
fixed "Expand" label, and setting the "labelled-by" relation to the
child of the GtkTreeExpander.

Establish a control relation between demo search and list

The search entry changes the content of the list view, so we should
mention that relation to assistive technologies.

a11y: Add accessible actions to GtkSearchEntry

Just like GtkPasswordEntry, GtkSearchEntry should have its set of
accessible actions.

a11y: Mark SearchEntry icons as presentational

While the "clear the search entry" icon behaves like a button, we don't
have any actual action that can trigger it, so let's ignore it.

a11y: Set the role on GtkSearchBar

The search bar widget has a "SEARCH" landmark role, which is described
as:

    A landmark region that contains a collection of items and
    objects that, as a whole, combine to create a search facility.

a11y: Icons in buttons are presentational

Buttons are described by text, and the icon child can be safely ignored.

a11y: Add more accessibility labels to GtkNotebook

Label the various components:

 - the tab list
 - the tab widget
 - the arrow widgets

a11y: Use the stack page title as its accessible label

a11y: GtkStack is a group of stack pages

Handle empty stack pages when creating an ATContext

If we don't have a widget inside GtkStackPage, we should use the default
GdkDisplay.

Unrealize the ATContext in StackPage on dispose

Otherwise we're going to try to unrealize it during the GtkStack
destruction, which will emit warnings.

a11y: Icons in WindowControls are presentational only

They don't contribute anything to the accessible description.

a11y: Ignore more structural roles when computing labels

These roles should not have a fallback name when explicitly unlabelled.

a11y: Add role exception for GtkScrolledWindow

ARIA does not have a "scroll pane" role, but AT-SPI does.

demo: Add more accessibility labels to the UI

Merge branch 'clear-search-entry' into 'master'

searchbar: Fix clearing search entry on hide

See merge request GNOME/gtk!2820

searchbar: Fix clearing search entry on hide

Commit fa3d1940bf2b36 added separate grab handling for GtkSearchEntry, but
didn't consider whether the bar was revealed or concealed. The expected
behavior for the latter is that the entry is cleared rather than focused,
fix the condition accordingly.

Merge branch 'ebassi/for-master' into 'master'

ATContext lifetime fixes

Closes #3341

See merge request GNOME/gtk!2811

Merge branch 'wip/jimmac/sassc-global-vars' into 'master'

Adwaita: avoid !global

See merge request GNOME/gtk!2816

Adwaita: avoid !global

- Work around having !global variables as sassc will
  no longer support it

docs: Add "Accessibility" section to various widgets

There are a few widgets that gained an accessible role, which means
adding an "Accessibility" section in their description.

Merge branch 'suggestion-entry-demo2' into 'master'

gtk-demo: Add suggestion entry demos

See merge request GNOME/gtk!2812

gtk-demo: Add suggestion entry demos

Add a possible replacement for GtkEntryCompletion
as a demo.

Move the Dropdowns demo to Lists/Selections, and make
it show both GtkDropDown and the suggestion entry, with
some variations.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2810

a11y: Simplify GtkModelButton

Instead of recreating GtkATContexts in order to change their role, we
can simply unrealize and realize them back.

a11y: Add missing fallback for accessible-role getter

If the per-instance accessible role is unset, use the class role.

a11y: Rework ownership and lifetime of GtkATContext

Now that GtkATContext is explicitly realized and unrealized, we should
always create an instance at widget initialization time, and drop it
during the widget finalization. This should make it easier to set up the
initial accessible state of a widget during the instance initialization,
as well as reduce the chances of accidental creation of GtkATContext
instances during the destruction sequence.

a11y: Defer to the GtkAccessible's implementation

Since GtkATContexts are now lazily realized, we need to go through the
GtkAccessible's implementation to access the :accessible-role property,
in case there are fallbacks.

a11y: Create AtSpiRoot on realization

There's no need to do a lot of work on construction, if we're delaying
all remote work after the GtkATContext is realized.

The GtkAtSpiContext should also keep a reference on the root, and drop
it at unrealize time.

a11y: Use GROUP role for GtkNotebook

A notebook is a grouping of a tab list, tabs, and tab pages.

a11y: Protect should_present() from empty contexts

If the GtkAccessible implementation returns a NULL context, we should
not be calling methods on it.

a11y: Do not leak the ATContext in GtkStackPage

GtkStackPage is not a widget, so it must release the reference on the
ATContext it owns.

a11y: Mark more containers as structural elements

Widgets that just provide grouping and layout to other widgets should
not be relevant to the accessible tree.

a11y: Use the window title as its label

a11y: Skip unlabelled structural roles

If a structural role is left unlabelled, just leave it unnamed.

a11y: Translate ARIA windows to AT-SPI frames

For backward compatibility with GTK3.

a11y: Add more ARIA/AT-SPI role translations

a11y: Realize parent ATContext for the stack page

Just like for popovers, the stack page is not directly connected on the
widget's DOM, so we need to realize the parent ATContext ourselves.

a11y: Implement missing atspi.Component getters

Some of them are entirely innocuous, and we can easily provide values
that match what GTK3 provides.

a11y: Unrealize ATContext on dispose()

By unrealizing the context we avoid additional work during the dispose
phase, in case widget code updates the accessible state. We use
GtkAccessible's API, to ensure we unrealize the right ATContext, instead
of the one we store inside GtkWidgetPrivate.

We drop the ATContext instance inside GtkWidget during finalization, to
mop up eventual vivifications there.

Adwaita: Don't do n-th child things for list rows

Making the list row child css depend on the position
is very expensive, and does not acutally work correctly
(since we don't have widgets for all children, so the
position of the child widget does not reflect the actual
model item position).

To make this more palatable, use the bottom border
instead of the top border, since most lists have a natural
border at the top (with headers), and may end up with
empty space at the bottom.

label: Avoid a needless strdup

Don't duplicate the string before we know if it
has actually changed.

label: Optimize GtkLabel setters

The overarching goal here is to not queue a resize
unless something has actually changed. In columnview
scenarios, we often deal with hundreds of labels.

Labels are cattle, not pets.

gtk-demo: Split off SvgPaintable

Put the SvgPaintable implementation into its
own source files, for ease of copying.

Don't hide widgets in dispose()

This is leftover code from when widgets were hidden
by default, and was setting them back to their initial
state.

This is getting in the way now, as hiding the widget
updates the HIDDEN accessible state, which ends up
re-creating the at context that we've already disposed
of, leading to memory leaks.

Merge branch 'matthiasc/builder-requires' into 'master'

Matthiasc/builder requires

See merge request GNOME/gtk!2806

Merge branch 'fix-demos-wo-pangoft2' into 'master'

gtk-demo: Fix building scrolling demo without PangoFT2

See merge request GNOME/gtk!2807

gtk-demo: Fix building scrolling demo without PangoFT2

For builds that do not have PangoFT2, the demo fails to link because we weren't
building listview_ucd.c.  Fix the build by building listview_ucd.c with
script-names.c and unicode-names.c for all builds, as we now require a Pango
version that already always depends on HarfBuzz and those sources do not use
anything from PangoFT2.

testsuite: Update buildertool tests

gtk-builder-tool simplify --3to4 now produces a
<requires lib="gtk" version="4.0"/>.
Adapt for that, and also add some tests that check that we
actually verify the requires, and accept 3.99 and 4.0, but
not 5.x.

buildertool: Supplant a requires

When we convert a ui file to GTK 4 syntax, we *know*
that it requires GTK 4, so put that in the output.

builder: Be a bit more strict about requires

Check that the major version matches (without this, the
requires check is really toothless), but allow 3.99 to
match 4.0.

testsuite: Remove <requires> from ui files

We don't need these here, the testsuite is shipped
with GTK.

examples: Remove requires from ui files

No need to check requires for things that are shipped
with GTK.

gtk4-demo: Remove <requires> from ui files

No need to check requires for things that are shipped
with GTK.

gtk: Remove <requires> from ui files

We don't need to check requirements for things
that are shipped *with* gtk.

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

Closes #3343 and #3342

See merge request GNOME/gtk!2804

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2805

docs: Add example of relations with lists of references

a11y: Clone GtkATContext in GtkModelButton

The hypothetical widget that needs to clone ATContext instances
because it needs to control the accessible role post-construction is
really GtkModelButton.

Fixes: #3342

a11y: Add private API to clone a GtkATContext

Some widgets might want to override GtkAccessible and create their own
context in order to control the accessible role post-construction time.
To avoid explicitly copying the existing state over from the original
ATContext to the new one, we need a way to clone the context's state
from inside the ATContext itself.

a11y: Do not copy the list of references

The constructor for GtkReferenceListAccessibleValue is transfer full,
which means we should not be copying the GList around.

Fixes: #3343

a11y: Parse reference lists using varargs

Using GList is a bit lame, and makes the API more complicated to use
than necessary in the common case.

The only real use case for a GList is gtk_widget_add_mnemonic_label(),
and for that we can use the GValue-based API instead.

Fixes: #3343

a11y: Add GValue initializers for accessible attributes

Consumers of the GValue-based API for GtkAccessible need to have a way
to initialize the GValue with the correct type for the given attribute.

a11y: Proxy GtkWidget:accessible-role

The accessible-role property in GtkWidget has three possible targets:

 - the :accessible-role of a GtkATContext, if realized
 - the accessible_role field of GtkWidgetPrivate
 - the accessible_role field of GtkWidgetClassPrivate

When we set the accessible role of a widget using the GObject property
mechanism, we want to either set the GtkWidgetPrivate.accessible_role
field, if there's no ATContext *or* if the ATContext is not realized.
Conversely, when we get the accessible-role property we want to have a
series of fallbacks in place:

 - if GtkAccessible.get_at_context() returns an ATContext, and that
   ATContext is realized, return the :accessible-role of the context
 - if GtkWidgetPrivate.accessible_role is not WIDGET, return the
   stored accessible role
 - return GtkWidgetClassPrivate.accessible_role

This should help catch the case of getting the accessible role of
widgets that override GtkAccessible.get_at_context(), like
GtkModelButton.

See: #3342

printdialog: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

fontchooser: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

columnview: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

x11: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

win32: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

wayland: Plug listmodel memory leaks

We were leaking references returned from g_list_model_get_item
in some places.

Update Ukrainian translation

Update Ukrainian translation

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2803

gtk-demo: Plug a memory leak

gtk-demo: Tweak a demo title

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2802

gkt-demo: Add a columview to the scroll demo

This is an interesting case, since it has many labels,
and we are struggling to provide good scrolling performance.

gtk-demo: Improve consistency

Make the shortcut triggers demo big enough
to not ellipsize the window title.

gtk-demo: Improve consistency

Make the paintable svg demo follow the same
pattern we use for other demos.

gtk-demo: Improve consistency

Make the paintable emblems demo follow the same
pattern we use for other demos.

gtk-demo: Set default size for drawingarea demo

Set a default size, so we don't ellipsize the window
title when the window is presented.

gtk-demo: Plug a memory leak

gtk-demo: Plug a memory leak

a11y: Clean up properly in unregister_object

Things that are set up in register_object should
be cleaned up in unregister_object.

Merge branch 'wip/jimmac/search-entry-icon' into 'master'

search entry: icon

Closes #3340

See merge request GNOME/gtk!2801

search entry: icon

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3340

Merge branch 'ebassi/for-master' into 'master'

docs: Add missing a11y environment variables

See merge request GNOME/gtk!2788

Merge branch 'kinetic-scroll-velocity-accumulation' into 'master'

scrolledwindow: Accumulate velocity with kinetic scrolling

See merge request GNOME/gtk!2768

a11y: Consolidate accessibility environment variables

Use a single environment variable for everything:

 - select the ATContext implementation
 - select the test ATContext
 - disable ATContext entirely

We use the same pattern as GSK_RENDERER, GTK_DEBUG, etc.

The documentation needs to be updated to include the environment
variable.

scrolledwindow: Accumulate velocity with kinetic scrolling

Accumulate existing velocity when decelerating from a swipe if the swipe
velocity is above a certain fraction of that existing velocity.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #3337

See merge request GNOME/gtk!2799

Remove GtkPlacesOpenFlags from public headers

The GtkPlacesOpenFlags enum is only used in private
API, so move it to private headers. Since we still need
a GType for it, add gtkplacessidebarprivate.h to the
headers we use for generating private enum types. In turn,
this registers the other private enums in that header, so
take the opportunity to fix their naming, and use the
generated types for the corresponding sidebarrow properties.

Fixes: #3337

docs: Document GTK_MEDIA

Add a paragraph about the GTK_MEDIA environment variable.

Revert "Update gtktreestore.c: gtk_tree_store_remove didn't have the proper comment annotation"

This reverts commit 32baa0a54990abec3c60deb0ee8008fbbfc9a809.

See discussion in https://gitlab.gnome.org/GNOME/gtk/-/issues/78
for the background.